home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-01
/
d14txt.zip
/
MEMOPAD.TXT
< prev
next >
Wrap
Text File
|
1992-06-26
|
46KB
|
1,456 lines
; ------------------------ MEMOPAD.TXT ---------------------
;
; This is the help text file for the MEMOPAD application. It
; includes the help text that a D-Flat application would use
; for the user interface.
;
; There can be a help window with a helptag name for each
; command in commands.h, each menu label on the menu bar
; as defined in menus.c, and each dialog box name in dialogs.c
;
; There can be other help windows as well. Some of them will
; be displayed as the result of hypertext and definition key
; words embedded in the help text of other help windows. Others
; can be implemented from within an application software system.
;
; Following is the format for a help window:
;
; ┌── (1st column of each line)
;
; ; anything with a semicolon in the 1st column is a comment
; <helptag> (names the help window)
; [<<]<helptag> (names the previous window in chain)
; [>>]<helptag> (names the next window in chain)
; Help Window Title (displays in window's title bar)
; Help text follows until next helptag occurs
; Hypertext reference [..keyword]<helptag> embedded in text
; Definition reference [**keyword]<helptag> embedded in text
; <helptag> (names another window)
;
; Notes:
; 1. A hypertext reference, when selected, causes the
; associated help window named by the <helptag> to
; become the active help window.
; 2. A definition reference, when selected, displays
; a momentary window with the text of the associated
; help window named by the <helptag>. The window
; closes when the user releases the Enter key or
; mouse button.
; 3. A definition window has no title.
; 4. The last window is followed by the <end> helptag.
; 5. The window's height and width adjust to the text.
; 6. The [..], [**], and <helptags> do not display and
; do not figure in the width of the line in which
; they occur.
;
; -----------------------------------------
<Application>
[<<]<MEMOPAD>
[>>]<Menubar>
Application Window
The Application Window is the desktop for the
application.
The Application window contains the application's
[..Document Windows]<docwindow>. Before you open any documents,
the Application window is empty.
The application window has an [..Action Bar]<Menubar> just below
its [..Title Bar]<titlebar> and a [..Status Bar]<statusbar> at the bottom.
Note that there might not be a title or status bar
depending on the [..Display]<ID_DISPLAY> option on the [..Options]<Options>
menu.
; -----------------------------------------
<MEMOPAD>
[>>]<Application>
The MEMOPAD Application
MEMOPAD is a multi-window notepad program that
demonstrates the programmer's [**API]<API> to the D-Flat
Common User Access interface library.
; -----------------------------------------
<MEMOPADDOC>
[<<]<Application>
The MEMOPAD Document Window
This [..Document Window]<docwindow> is a basic notepad text editor. You can
have many of these windows open at one time.
; -----------------------------------------
<docwindow>
Document Window
A Document Window contains the data that you work
on. It displays within the [..Application Window]<Application> and
consists of these parts:
[..Client Area]<client>
[..Border]<border>
[..Title Bar]<titlebar>
[..Status Bar]<statusbar>
[..Scroll Bars]<scrollbar>
[..Control Box]<controlbox>
[..Minimize Box]<minbox>
[..Maximize Box]<maxbox>
[..Restore Box]<restorebox>
[..Resize Box]<sizebox>
; -----------------------------------------
<client>
[<<]<docwindow>
[>>]<border>
Client Area
The Client Area is the space inside the window's
borders where the application's data values are
displayed and manipulated.
; -----------------------------------------
<border>
[<<]<client>
[>>]<titlebar>
Border
The Border is the frame around a window. When the
window has the focus, the border is a double line.
When a different window has the focus, the border
is a single line.
The window's [..Scroll Bars]<scrollbar>, if any, are positioned
in the right and bottom parts of the border.
; -----------------------------------------
<titlebar>
[<<]<border>
[>>]<statusbar>
Title Bar
The Title Bar is at the top of the window and
contains the window's title. When the window
has the focus, the title is highlighted. The
Title Bar includes these items as well:
[..Control Box]<controlbox>
[..Minimize Box]<minbox>
[..Maximize Box]<maxbox>
[..Restore Box]<restorebox>
You can move the window with the mouse by clicking
the title bar and dragging the window to its new
location.
; -----------------------------------------
<statusbar>
[<<]<titlebar>
[>>]<scrollbar>
Status Bar
The Status Bar is at the bottom of the application window.
It displays the time and brief contextual messages about
the menus and other application-dependent features.
; -----------------------------------------
<scrollbar>
[<<]<statusbar>
[>>]<controlbox>
Scroll Bars
You use Scroll Bars to scroll a window's data with the
mouse. A window can have one or two Scroll Bars - one
at the right and one at the bottom parts of the
window's Border. The Scroll Bar at the right scrolls
the document's data up and down. The Scroll Bar on
the bottom scrolls the window's data right and left.
To scroll a window a line at a time, click the arrow
tokens at either end of the Scroll Bar. The Scroll Bar
includes a slider box that indicates the relative
position of the window's display with respect to the
total document. You can page to an approximate position
within the document by clicking inside the Scroll Bar.
You can drag the slider box in either direction to
scroll the document.
; -----------------------------------------
<controlbox>
[<<]<scrollbar>
[>>]<minbox>
Control Box
The Control Box is indicated by the character (≡) at
the left end of the window's [..Title Bar]<titlebar>. You can
click it to select the System Menu or double click
it to close the window.
; -----------------------------------------
<minbox>
[<<]<controlbox>
[>>]<maxbox>
Minimize Box
The Minimize Box is the token at the right
end of the window's [..Title Bar]<titlebar>.
When you click on the Minimize Box, the window
is reduced to an icon at the bottom of the
[..Application Window]<Application>
; -----------------------------------------
<maxbox>
[<<]<minbox>
[>>]<restorebox>
Maximize Box
The Maximize Box is the token at the right
end of the window's [..Title Bar]<titlebar>.
When you click on the Maximize Box, the window
grows to occupy the entire [..Client Area]<client> of the
[..Application Window]<Application>
; -----------------------------------------
<restorebox>
[<<]<maxbox>
[>>]<sizebox>
Restore Box
The Restore Box is the token character at the right
end of a minimized window's [..Title Bar]<titlebar> and the token
character at the right end of a maximized window's
Title Bar. You click the Restore Box to restore the
window to the position and size it had before it was
minimized or maximized.
; -----------------------------------------
<sizebox>
[<<]<restorebox>
Resize Box
The Resize Box is the lower right corner of the
window's border. To change the window's size,
drag the Resize Box. The window's upper left
coordinates remain the same, and the lower right
coordinates change as you drag the mouse around.
; -----------------------------------------
<Menubar>
[<<]<application>
[>>]<Pulldowns>
The Action Bar
To select the action bar, do one of these:
1. Press F10
2. Press and release the Alt key
3. Press Alt+the letter that is highlighted
in a menu's title on the action bar. The
selected menu will pull down.
4. Click the action bar. If you click a
pull-down menu selection's title, that
menu will pull down.
To exit from the action bar and return to the
document or application window, do one of these:
1. Press Esc
2. Press and release the Alt key
; -----------------------------------------
;
; Following are the Help system windows
;
; -----------------------------------------
<HelpHelp>
[<<]<Help>
[>>]<ExtHelp>
Help for Help
Getting Into the Help System
----------------------------
There are three ways to get into the Help system:
1. Execute commands on the [..Help]<Help> menu
2. Press F1
3. Press the Help command button on a dialog box.
Contextual Help (F1)
--------------------
The F1 key provides contextual help--help for the
part of the application that currently has the
focus. You can press F1 with the action bar selected,
a pull-down menu displayed, a field on a dialog box
selected, or a document window in focus.
The Help Command Button
-----------------------
The Help command button on a dialog box displays
information about the dialog box and its purpose.
The help window that displays when you press F1 with
a dialog box field selected relates to the field
itself.
References to Other Help Windows
--------------------------------
A Help window can include a reference to another
help window. That reference is highlighted like
this:
[..Help]<Help>
You can Tab to the highlighted reference and press
the Enter key to select the referenced help window.
You can select it with the mouse by double-clicking
on it.
Definitions
-----------
Some references, such as [**function key]<shortcut>, are
definitions of terms. These definitions are
highlighted the same as references. When you select
the definition, a window displays in the upper left
corner of the desktop. The window contains the
definition of the selected term and stays in view
until you release the Enter key or the mouse
button.
Command Buttons on the Help Windows
-----------------------------------
Each help window contains these [..command buttons]<cmdbuttons>:
Close This button closes the help window and
exits from the help system.
Back This button changes to the help window
that you viewed before the current one.
Prev This button changes to the help window
that logically preceeds the current one.
Next This button changes to the help window
that logically follows the current one.
Exiting from the Help System
----------------------------
You exit from the Help system by closing the current
help window in one of these three ways:
1. Press the Esc key
2. Use the Close command button on the Help
window.
5. Double click the window's [..Control Box]<controlbox>.
4. Close the help window from its [..System Menu]<sysmenu>.
; -----------------------------------------
<ExtHelp>
[<<]<HelpHelp>
[>>]<KeysHelp>
Extended Help
The MEMOPAD program has few features and procedures
that are not taken directly from the SAA/CUA
interface that D-Flat implements. The [..Log Messages]<ID_LOG>
and [..Display]<ID_DISPLAY> selections on the [..Options]<Options> menu are
unique to MEMOPAD and would not necessarily be in
an application. Some of the Display features would
be useful to a user who is not developing D-Flat
programs. Others, such as the [..Title]<ID_TITLE>, [..Border]<ID_BORDER>,
[..Status Bar]<ID_STATUSBAR>, and [..Texture]<ID_TEXTURE> check boxes on the [..Display]<Display>
dialog box, are to allow a programmer to see how
the screen looks with these features enabled and
disabled.
; -----------------------------------------
<KeysHelp>
[<<]<ExtHelp>
[>>]<HelpIndex>
Keys Help
From the Desktop
----------------
Alt+Hyphen Open the desktop's [..SystemMenu]<sysmenu>.
F10 or Alt Activate the [..ActionBar]<menubar>.
Esc Deactivate the Action Bar.
Alt+letter Open the associated [..Pull-down menu]<Pulldowns>.
Alt+F6 Change focus to another document.
Alt+X Exit the application.
From a [..Document Window]<docwindow>
----------------------
Alt+Spacebar Open the window's [..System Menu]<sysmenu>
Alt+S Save the document to a disk file.
[..Edit Box]<editbox> Keys
-----------
Arrow keys Move the cursor one character.
Ctrl+arrow Move the cursor one word.
Del Delete character to the right of
the cursor. If a [..block]<Block> is marked,
delete the block.
Backspace Delete character to the left of
the cursor. If a block is marked,
delete the block.
Alt+BackSpace Undo the last block deletion.
PgUp/PgDn Scroll forward and back one page.
Ctrl+PgUp/PgDn Scroll horizontally one page.
Home/End Move the cursor to the beginning
and end of the line.
Ctrl+Home/End Move the cursor to the beginning
and end of the document.
Alt+P Form a paragraph from the cursor
position to the next blank line.
Ins Toggle Insert/Overstrike mode.
Tab Tab to the next Tab Stop position.
[..Clipboard]<clipboard> Keys
--------------
Shift+Del [..Cut]<ID_CUT> the marked text to the
Clipboard
Ctrl+Ins [..Copy]<ID_COPY> the marked text to the
Clipboard.
Shift+Ins [..Paste]<ID_PASTE> the contents of the
Clipboard into the document.
[..Dialog Box]<dialog> Keys
---------------
Tab Move to the next control.
Shift+Tab Move to the previous control.
Enter Execute the control.
Esc Close the Dialog Box with no
action.
[..Listbox]<listbox> Keys
------------
Up/down arrows Move the selection cursor
Ctrl+arrows Select a group of entries.
Enter Choose the selected entry
or entries.
Shift+F8 Toggle Add mode.
Spacebar In Add mode, select/deselect an
entry.
; -----------------------------------------
<HelpIndex>
[<<]<KeysHelp>
Index of Help Titles
Select (Tab then Enter or double-click) from these
titles to view the help screens related to each one.
[..Application Window]<Application>
[..Action Bar]<Menubar>
[..Pull-down Menus]<Pulldowns>
[..The File Menu]<File>
[..The Edit Menu]<Edit>
[..The Search Menu]<Search>
[..The Utilities Menu]<Utilities>
[..The Options Menu]<Options>
[..The Window Menu]<Window>
[..The Help Menu]<Help>
[..Dialog Boxes]<Dialog>
[..The File Open Dialog Box]<FileOpen>
[..The Save As Dialog Box]<SaveAs>
[..The MsgBox Dialog Box]<MsgBox>
[..The Display Dialog Box]<Display>
[..The Windows Dialog Box]<Windows>
[..The Log Dialog Box]<Log>
[..The Help System]<Help>
[..Help for help...]<ID_HELPHELP>
[..Extended help...]<ID_EXTHELP>
[..Keys help...]<ID_KEYSHELP>
[..Help index...]<ID_HELPINDEX>
[..Reload Help Database]<ID_LOADHELP>
; -----------------------------------------
;
; Following are menu command help windows
;
; -----------------------------------------
<ID_NEW>
[<<]<File>
[>>]<ID_OPEN>
The New Command
This command opens a new, untitled document
window. An untitled document is one that has
not been given a file name. When you use the
[..Save]<ID_SAVE> or [..Save as]<ID_SAVEAS> command on the File menu the
document gets a file name.
; -----------------------------------------
<ID_OPEN>
[<<]<ID_NEW>
[>>]<ID_SAVE>
The Open Command
This command opens an existing document and loads
it into a window. You select the document by filling
in the [..File Open]<FileOpen> dialog box.
; -----------------------------------------
<ID_SAVE>
[<<]<ID_OPEN>
[>>]<ID_SAVEAS>
The Save Command
This command saves the document in the currently
active document window into a disk file. The file
name is the same as when the file was loaded. If
the window contains an untitled document, this
command works just like the [..Save as]<ID_SAVEAS> command.
; -----------------------------------------
<ID_SAVEAS>
[<<]<ID_SAVE>
[>>]<ID_DELETEFILE>
The Save As Command
This command allows you to save the document in the
currently active document window under a new file
name. You specify the file's name by filling in the
fields on the [..Save as]<SaveAs> dialog box.
The new file name becomes the title of the
currently active document window where the file is
displayed.
; -----------------------------------------
<ID_DELETEFILE>
[<<]<ID_SAVEAS>
[>>]<ID_PRINT>
The Delete Command
Use this command to delete the text file displayed
in the active editbox window.
; -----------------------------------------
<ID_PRINT>
[<<]<ID_DELETEFILE>
[>>]<ID_PRINTSETUP>
The Print Command
This command prints the document in the
currently-selected document window.
; -----------------------------------------
<ID_PRINTSETUP>
[<<]<ID_PRINT>
[>>]<ID_DOS>
The Print Setup Command
This command displays the [..Print Setup]<PrintSetup> dialog
box to allow you to change the printer port
and margins for the printout.
; -----------------------------------------
<ID_DOS>
[<<]<ID_PRINT>
[>>]<ID_EXIT>
The DOS Command
This command "shells" out to DOS. You return to the
application from DOS by executing the DOS exit
command at the DOS command line.
; -----------------------------------------
<ID_EXIT>
[<<]<ID_DOS>
The Exit Command
This command exits to DOS from the application. If
there are any changed documents that you have not
saved, the program will ask if you want to save
them and allow you to do so, one at a time.
; -----------------------------------------
<ID_UNDO>
[<<]<Edit>
[>>]<ID_CUT>
The Undo Command
This command "undoes" the most recent [..Delete]<ID_DELETETEXT> or
[..Clear]<ID_CLEAR> command. The text that was deleted by one of
these commands is written into the document at the
current cursor location.
; -----------------------------------------
<ID_CUT>
[<<]<ID_UNDO>
[>>]<ID_COPY>
The Cut Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
deletes the text in the marked block, copies it to
the [..Clipboard]<Clipboard>, and closes up the space in the
document that the text previously occupied.
; -----------------------------------------
<ID_COPY>
[<<]<ID_CUT>
[>>]<ID_PASTE>
The Copy Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
copies the text in the marked block to the
[..Clipboard]<Clipboard>, and closes up the space in the document
that the text previously occupied.
; -----------------------------------------
<ID_PASTE>
[<<]<ID_COPY>
[>>]<ID_CLEAR>
The Paste Command
This command is active only when the [..Clipboard]<Clipboard>
contains text. The command inserts the text from the
Clipboard into the currently active document window
at the current cursor location.
; -----------------------------------------
<ID_CLEAR>
[<<]<ID_PASTE>
[>>]<ID_DELETETEXT>
The Clear Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
deletes the block of text, leaving empty space in
the document where the text had been.
You can undo the text deletion with the
[..Undo]<ID_UNDO> command.
; -----------------------------------------
<ID_DELETETEXT>
[<<]<ID_CLEAR>
[>>]<ID_PARAGRAPH>
The Delete Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
deletes the block of text, closing the space in the
document where the text had been.
You can undo the text deletion with the
[..Undo]<ID_UNDO> command.
; -----------------------------------------
<ID_PARAGRAPH>
[<<]<ID_DELETETEXT>
The Paragraph Command
This command reforms a paragraph beginning at the
current keyboard cursor position. The end of the
paragraph is the last line preceding the next blank
line.
; -----------------------------------------
<ID_SEARCH>
[<<]<Search>
[>>]<ID_REPLACE>
The Search Command
This command opens the [..Search Text]<SearchTextDB> Dialog Box to
allow you to search the text for a
matching string.
; -----------------------------------------
<ID_REPLACE>
[<<]<ID_SEARCH>
[>>]<ID_SEARCHNEXT>
The Replace Command
This command opens the [..Replace Text]<ReplaceText> Dialog Box to
allow you to search the text for a
matching string and replace it with a
different text string.
; -----------------------------------------
<ID_SEARCHNEXT>
[<<]<ID_REPLACE>
The Next Command
This command continues the most recent [..Search]<ID_SEARCH>
command beginning at the current cursor position.
; -----------------------------------------
<ID_INSERT>
[<<]<Options>
[>>]<ID_WRAP>
The Insert Toggle
This [**toggle]<toggle> command turns the editor's insert mode
on and off. When insert mode is on, the editor
inserts the text that you write. Otherwise each
character typed overwrites the one at the current
cursor position.
; -----------------------------------------
<ID_WRAP>
[<<]<ID_INSERT>
[>>]<ID_TABS>
The Word Wrap Toggle
This [**toggle]<toggle> command turns the editor's word wrap
feature on and off. When word wrap is on, the editor
will wrap words as you type at the right margin of
the document window. When word wrap is off, the
editor will scroll the display horizontally as you
type beyond the right margin.
; -----------------------------------------
<ID_TAB?>
[<<]<ID_WRAP>
[>>]<ID_DISPLAY>
The Tabs Command
This command allows you to
change the editor's tab settings.
; -----------------------------------------
<ID_DISPLAY>
[<<]<ID_TABS>
[>>]<ID_LOG>
The Display Command
This command displays the [..Display]<Display> dialog box to
allow you to modify the screen's colors and
configuration.
; -----------------------------------------
<ID_LOG>
[<<]<ID_DISPLAY>
[>>]<ID_SAVEOPTIONS>
The Log Messages Command
This command is used primarily for debugging. It
opens the [..Log Message]<Log> dialog box to allow the
programmer to select the D-Flat messages to log and
to turn message logging on and off.
; -----------------------------------------
<ID_SAVEOPTIONS>
[<<]<ID_LOG>
The Save Options Command
This command saves the current options in a
configuration file that the application reads when
it first starts up.
; -----------------------------------------
<ID_CLOSEALL>
[<<]<Window>
[>>]<ID_WINDOW>
The Close All Command
This command closes all the document windows on the
desktop.
; -----------------------------------------
<ID_WINDOW>
[<<]<ID_CLOSEALL>
[>>]<ID_MOREWINDOWS>
The Open Window List
The [..Window]<Window> menu displays a list of open document
windows. You can select one of them as the current
active window by selecting its title on the Window
menu. When the menu first displays, the active
window has a check mark (√) next to it.
<ID_MOREWINDOWS>
[<<]<ID_WINDOW>
More Windows
This command indicates that there are more open document
windows than the [..Window]<Window> menu can display.
Choose this command to see the [..Windows]<Windows> dialog box.
; -----------------------------------------
<ID_HELPHELP>
[<<]<Help>
[>>]<ID_EXTHELP>
Help for Help
This command describes how to use the Help system.
; -----------------------------------------
<ID_EXTHELP>
[<<]<ID_HELPHELP>
[>>]<ID_KEYSHELP>
Extended Help
Extended Help displays information about the
application.
; -----------------------------------------
<ID_KEYSHELP>
[<<]<ID_EXTHELP>
[>>]<ID_HELPINDEX>
Keys Help
This command displays a help window that shows the
keystrokes that you use to operate the application.
; -----------------------------------------
<ID_HELPINDEX>
[<<]<ID_KEYSHELP>
[>>]<ID_LOADHELP>
Help Index
The Help index lists the subjects covered in the
Help database. You can go directly to a subject from
the index by selecting the subject's name.
; -----------------------------------------
<ID_LOADHELP>
[<<]<ID_HELPINDEX>
[>>]<ID_ABOUT>
Reload Help Database
This command allows you to reload the Help
database. It is useful when you use the
Memopad program to modify its Help database.
You can change and save the MEMOPAD.TXT file,
use this command to reload it, then use the
Help system to view the results. Without this
command, your changes would corrupt the
current Memopad's picture of the database
with respect to its pointers.
You must delete the MEMOPAD.HLP compressed
help database in order for this program to
load the most recent changes.
; -----------------------------------------
<ID_ABOUT>
[<<]<ID_LOADHELP>
The About Command
This command displays a message that tells you what
the application is.
; -----------------------------------------
<ID_FILENAME>
[>>]<ID_FILES>
The Filename Field
On the Open File dialog box:
Enter the name of the file you wish to
open into a document window, or enter
the file specification with wild cards
to display a list of files in the
[..Files]<ID_FILES> field.
On the Save As dialog box:
Enter the name with which you wish to
save the file.
; -----------------------------------------
<ID_FILES>
[<<]<ID_FILENAME>
[>>]<ID_DRIVE>
The Files Field
Select a file from the listbox by using one
of these methods:
Keyboard: Move the selection cursor to
the file name and press Enter.
Mouse: Double-click the file name.
; -----------------------------------------
<ID_DRIVE>
[<<]<ID_FILES>
The Directories Field
Use this listbox to select a different
drive or subdirectory. Select a drive or
subdirectory from the listbox by using one
of these methods:
Keyboard: Move the selection cursor to
the drive or subdirectory and
press Enter.
Mouse: Double-click the drive or
subdirectory.
; -----------------------------------------
<ID_PRINTERPORT>
[<<]<PrintSetup>
[>>]<ID_LEFTMARGIN>
The Printer Port Combo Box
Use this combo box to change the printer
port and to set the report's margins.
; -----------------------------------------
<ID_LEFTMARGIN>
[<<]<ID_PRINTERPORT>
[>>]<ID_RIGHTMARGIN>
The Left Margin Spin Button
Change the left margin by increasing
and decreasing the value in this
spin box.
; -----------------------------------------
<ID_RIGHTMARGIN>
[<<]<ID_LEFTMARGIN>
[>>]<ID_TOPMARGIN>
The Right Margin Spin Button
Change the right margin by increasing
and decreasing the value in this
spin box.
; -----------------------------------------
<ID_TOPMARGIN>
[<<]<ID_RIGHTMARGIN>
[>>]<ID_BOTTOMMARGIN>
The Top Margin Spin Button
Change the top margin by increasing
and decreasing the value in this
spin box.
; -----------------------------------------
<ID_BOTTOMMARGIN>
[<<]<ID_TOPMARGIN>
The Bottom Margin Spin Button
Change the bottom margin by increasing
and decreasing the value in this
spin box.
; -----------------------------------------
<ID_SEARCHFOR>
[>>]<ID_REPLACEWITH>
The Search For Text Entry Box
Enter the text you want to search for in this
text box. Press Enter or the OK command button
to begin the search. Press Esc to forget it.
Use the [..Match Upper/Lower Case Check Box]<ID_MATCHCASE> to
select whether the search will match only if
the case matches or if the search is insensitive
to the case of the two strings.
; -----------------------------------------
<ID_REPLACEWITH>
[<<]<ID_SEARCHFOR>
[>>]<ID_MATCHCASE>
The Replace With Text Entry Box
Enter the text string that will replace
the matching text string in the
[..Search For Text Entry Box]<ID_SEARCHFOR>.
; -----------------------------------------
<ID_MATCHCASE>
[<<]<ID_REPLACEWITH>
[>>]<ID_REPLACEALL>
The Match Upper/Lower Case Check Box
Use this checkbox to select whether the search
will match only if the case matches or if the
search is insensitive to the case of the two
strings.
; -----------------------------------------
<ID_REPLACEALL>
[<<]<ID_MATCHCASE>
The Replace Every Match Check Box
Use this checkbox to select whether the search
will replace every match in the document.
; -----------------------------------------
<ID_TITLE>
[<<]<Display>
[>>]<ID_BORDER>
The Title Check Box
Select this Check Box to toggle the application
window's title on and off. Without a title, the
window also loses its [..Control Box]<controlbox>.
; -----------------------------------------
<ID_BORDER>
[<<]<ID_TITLE>
[>>]<ID_STATUSBAR>
The Border Check Box
Select this Check Box to toggle the application
window's border on and off. Without a border, the
window also loses its [..Status Bar]<statusbar>.
; -----------------------------------------
<ID_STATUSBAR>
[<<]<ID_BORDER>
[>>]<ID_TEXTURE>
The Status Bar Check Box
Select this Check Box to toggle the application
window's [..Status Bar]<statusbar> on and off.
; -----------------------------------------
<ID_TEXTURE>
[<<]<ID_STATUSBAR>
[>>]<ID_COLOR>
The Texture Check Box
Select this Check Box to toggle the application
window's background texture on and off.
; -----------------------------------------
<ID_COLOR>
[<<]<ID_TEXTURE>
[>>]<ID_MONO>
The Color Option Button
Select this option for a color display.
; -----------------------------------------
<ID_MONO>
[<<]<ID_COLOR>
[>>]<ID_REVERSE>
The Mono Option Button
Select this option for a monochrome display.
; -----------------------------------------
<ID_REVERSE>
[<<]<ID_MONO>
[>>]<ID_25LINES>
The Reverse Option Button
Select this option for a reverse monochrome
display. You might find that this option
works well with the LCD screens of some laptop
computers, particularly when you turn off the
[..Texture]<ID_TEXTURE> check box.
; -----------------------------------------
<ID_25LINES>
[<<]<ID_REVERSE>
[>>]<ID_43LINES>
The 25 Lines Option Button
Use this button to select a 25-line display.
; -----------------------------------------
<ID_43LINES>
[<<]<ID_25LINES>
[>>]<ID_50LINES>
The 43 Lines Option Button
Use this button to select a 43-line display.
(EGA and VGA)
; -----------------------------------------
<ID_50LINES>
[<<]<ID_43LINES>
[>>]<ID_SNOWY>
The 50 Lines Option Button
Use this button to select a 50-line display.
(VGA only)
; -----------------------------------------
<ID_SNOWY>
[<<]<ID_50LINES>
Snowy Display
Select this check box if your display
(usually a CGA) displays video snow when
you change the screen.
; -----------------------------------------
<ID_LOGLIST>
[<<]<Options>
[>>]<ID_LOGGING>
The Messages Listbox
This is a list of D-Flat messages that
you can log when the [..Logging]<ID_LOGGING> checkbox is
selected. The list is a [..Multiple-Selection]<MultiSel>
listbox.
; -----------------------------------------
<ID_LOGGING> [<<]<ID_LOGLIST> The Logging
CheckBox This checkbox turns message
logging on and off. ;
-----------------------------------------
<TEXTBOX> The TEXTBOX Window Class
======== Text needed =========
; -----------------------------------------
<LISTBOX>
The LISTBOX Window Class
======== Text needed =========
; -----------------------------------------
<EDITBOX>
The EDITBOX Window Class
======== Text needed =========
; -----------------------------------------
<Pulldowns>
[<<]<menubar>
[>>]<File>
Pull-down Menus
Pull-down menus contain the commands to operate
the program. Read about the [..Action Bar]<menubar> to see
how to select the pull-down menus. Following
is a list of the pull-down menus.
[..The File Menu]<File>
[..The Edit Menu]<Edit>
[..The Search Menu]<Search>
[..The Options Menu]<Options>
[..The Window Menu]<Window>
[..The Help Menu]<Help>
The [..System Menu]<sysmenu> is another kind of pull-down menu.
; -----------------------------------------
<File>
[<<]<Pulldowns>
[>>]<Edit>
The File Menu
The File menu contains commands that
open, save, and print files. The menu
also has the command that exits the
program. Following are the commands
and associated [**function keys]<shortcut>.
[..New]<ID_NEW>
[..Open]<ID_OPEN>
[..Save]<ID_SAVE> (Alt+S)
[..Save as]<ID_SAVEAS>
[..Print]<ID_PRINT>
[..Exit]<ID_EXIT> (Alt+X or Alt+F4)
[**Inactive]<inactive> commands display in a dim font.
; -----------------------------------------
<Edit>
[<<]<File>
[>>]<Search>
The Edit Menu
The Edit menu contains commands that support
text editing. Following are the commands and
associated [**function keys]<shortcut>.
[..Undo]<ID_UNDO> (Alt+BS)
[..Cut]<ID_CUT> (Shift+Del)
[..Copy]<ID_COPY> (Ctrl+Ins)
[..Paste]<ID_PASTE> (Shift+Ins)
[..Clear]<ID_CLEAR>
[..Delete]<ID_DELETETEXT> (Del)
[..Paragraph]<ID_PARAGRAPH> (Alt+P)
[**Inactive]<inactive> commands display in a dim font.
; -----------------------------------------
<Search>
[<<]<Edit>
[>>]<Utilities>
The Search Menu
The Search menu allows you to search the text
for a matching string. The commands are:
[..Search]<ID_SEARCH>
[..Next]<ID_SEARCHNEXT> (F3)
; -----------------------------------------
<Utilities>
[<<]<Search>
[>>]<Options>
The Utilities Menu
The Utilities Menu has two commands that
demonstrate the use of the PICTUREBOX window
class. The commands are:
[..Calendar]<ID_CALENDAR>
[..Bar Chart]<ID_BARCHART>
; -----------------------------------------
<Options>
[<<]<Utilities>
[>>]<Window>
The Options Menu
The Options menu contains commands that let you
control the editor's behavior, the video display
characteristics, and whether to [**log]<logging> messages.
You can save the options in a configuration file.
Following are the commands on the Options menu.
[..Insert]<ID_INSERT> (Ins)
[..Word wrap]<ID_WRAP>
[..Tabs]<ID_TABS>
[..Display]<ID_DISPLAY>
[..Log Messages]<ID_LOG>
[..Save Options]<ID_SAVEOPTIONS>
; -----------------------------------------
<Window>
[<<]<Options>
[>>]<Help>
The Window Menu
The Window menu has no selections unless the
[..Application window]<Application> has one or more document
windows displayed. When documents are displayed,
the Window menu contains a [..Close All]<ID_CLOSEALL> command
and an entry for the first nine document windows.
You can select a document window from the Window
menu. If the Application window has more than nine
document windows, the Window menu has the [**More Windows]<MoreWins>
command, which displays the [..Windows]<Windows> dialog box.
; -----------------------------------------
<Help>
[<<]<Window>
The Help Menu
The Help menu provides information about the
application and the desktop. The selections are:
[..Help for help...]<ID_HELPHELP>
[..Extended help...]<ID_EXTHELP>
[..Keys help...]<ID_KEYSHELP>
[..Help index...]<ID_HELPINDEX>
[..About...]<ID_ABOUT>
; -----------------------------------------
<sysmenu>
[<<]<Pulldowns>
[>>]<ID_SYSRESTORE>
The System Menu
Most windows have a system menu. If the window has a
System Menu, the window will have a [..Control Box]<controlbox>. You
can select the System Menu by clicking the control
box or by pressing Alt+Spacebar for the application
window's system menu and Alt+Hyphen for the system
menu of other windows.
Following are the commands on the System Menu:
[..Restore]<ID_SYSRESTORE>
[..Move]<ID_SYSMOVE>
[..Size]<ID_SYSSIZE>
[..Minimize]<ID_SYSMINIMIZE>
[..Maximize]<ID_SYSMAXIMIZE>
[..Close]<ID_SYSCLOSE>
; -----------------------------------------
<ID_SYSRESTORE>
[<<]<sysmenu>
[>>]<ID_SYSMOVE>
The Restore Command on the System Menu
This command restores a [..Minimized]<ID_SYSMINIMIZE> or [..Maximized]<ID_SYSMAXIMIZE>
window to the size and position it had before it
was minimized or maximized.
You can also restore a minimized or maximized
window by clicking its [..Restore Box]<restorebox>.
; -----------------------------------------
<ID_SYSMOVE>
[<<]<ID_SYSRESTORE>
[>>]<ID_SYSSIZE>
The Move Command on the System Menu
The Move command lets you move a window with the
keyboard. Select the command from the System Menu. A
movable window frame comes into view over the
window's border. Use the up, down, left, and right
arrow keys to move the frame to the new window
position. Press the Enter key when the movable frame
is where you want to move the window. Press the Esc
key to ignore the movement.
You can move a window with the mouse by clicking on
the window's [..Title Bar]<titlebar> and dragging the window to
the new location.
; -----------------------------------------
<ID_SYSSIZE>
[<<]<ID_SYSMOVE>
[>>]<ID_SYSMINIMIZE>
The Size Command on the System Menu
The Size command lets you re-size a window with the
keyboard. Select the command from the System Menu.
A sizeable window frame comes into view over the
window's border. Use the up, down, left, and right
arrow keys to change the frame to the new window
size. Press the Enter key when the sizeable frame
is the size you want for the window. Press the Esc
key to ignore the size change.
You can re-size a window with the mouse by clicking
on the window border's [..Resize Box]<sizebox> and dragging the
window to the new size.
; -----------------------------------------
<ID_SYSMINIMIZE>
[<<]<ID_SYSSIZE>
[>>]<ID_SYSMAXIMIZE>
The Minimize Command on the System Menu
This command minimizes the window to an icon at the
bottom of the application window.
You can minimize a window with the mouse by clicking
on the window's [..Minimize Box]<minbox>.
The [..Restore]<ID_SYSRESTORE> command restores a minimized window to
the size and position it had before it was
minimized.
; -----------------------------------------
<ID_SYSMAXIMIZE>
[<<]<ID_SYSMINIMIZE>
[>>]<ID_SYSCLOSE>
The Maximize Command on the System Menu
This command maximizes the window to occupy all of
the application window's client area.
You can maximize a window with the mouse by clicking
on the window's [..Maximize Box]<maxbox>.
The [..Restore]<ID_SYSRESTORE> command restores a maximized window to
the size and position it had before it was
maximized.
; -----------------------------------------
<ID_SYSCLOSE>
[<<]<ID_SYSMAXIMIZE>
The Close Command on the System Menu
This command closes the window with which the System
Menu is associated.
You can also close the window by double-clicking the
[..Control Box]<controlbox> or pressing Ctrl+F4.
; -----------------------------------------
;
; Following are dialog box help windows
;
; -----------------------------------------
<Dialog>
[>>]<cmdbuttons>
Dialog Boxes
Dialog Boxes allow you to enter data into the
application. A Dialog Box consists of these
controls:
[..Command Buttons]<cmdbuttons>
[..Check Boxes]<checkboxes>
[..Option Buttons]<optbuttons>
[..Edit Boxes]<editboxes>
[..List Boxes]<listboxes>
[..Multiple-Selection Listboxes]<MultiSel>
[..Combo Boxes]<combobox>
[..Spin Buttons]<spinbutton>
Move from control to control by using the Tab key
or by pressing Alt+ the highlighted character in
the control's label. Execute a control by pressing
the Enter key.
Exit the Dialog Box and accept its data entries by
executing the OK command button.
Exit the Dialog Box and reject its data entries by
executing the Cancel command button.
; -----------------------------------------
<cmdbuttons>
[<<]<Dialog>
[>>]<checkboxes>
Command Buttons
Select a command button to execute its
command by using one of these procedures:
1. Click the button.
2. Press Alt+ the shortcut key.
3. Tab to the button and press Enter.
; -----------------------------------------
<checkboxes>
[<<]<cmdbuttons>
[>>]<optbuttons>
Check Boxes
A check box can be on [X] or off [ ].
Toggle the check box with one of these
procedures:
1. Click the check box.
2. Press Alt+ the shortcut key.
; -----------------------------------------
<optbuttons>
[<<]<checkboxes>
[>>]<editboxes>
Option Buttons
Option buttons are in groups of 2 or
more. One option button in a group
is on () and the others are off ( ).
Select the option button with one of
these procedures:
1. Click the option button.
2. Press Alt+ the shortcut key.
; -----------------------------------------
<editboxes>
[<<]<optbuttons>
[>>]<listboxes>
Edit Boxes
======== Text needed =========
; -----------------------------------------
<listboxes>
[<<]<editboxes>
[>>]<MultiSel>
List Boxes
======== Text needed =========
; -----------------------------------------
<MultiSel>
[<<]<listboxes>
[>>]<combobox>
Multiple-Selection Listboxes
======== Text needed =========
; -----------------------------------------
<combobox>
[<<]<MultiSel>
[>>]<spinbutton>
Combo Boxes
======== Text needed =========
; -----------------------------------------
<spinbutton>
[<<]<combobox>
Spin Buttons
======== Text needed =========
; -----------------------------------------
<FileOpen>
The File Open Dialog Box
======== Text needed =========
; -----------------------------------------
<SaveAs>
The Save As Dialog Box
======== Text needed =========
; -----------------------------------------
<PrintSetup>
The Print Setup Dialog Box
======== Text needed =========
; -----------------------------------------
<SearchTextDB>
The Search Text Dialog Box
======== Text needed =========
; -----------------------------------------
<ReplaceTextDB>
The Replace Text Dialog Box
======== Text needed =========
; -----------------------------------------
<MsgBox>
The MsgBox Dialog Box
======== Text needed =========
; -----------------------------------------
<Display>
The Display Dialog Box
======== Text needed =========
[..Title]<ID_TITLE>
[..Border]<ID_BORDER>
[..Status Bar]<ID_STATUSBAR>
[..Texture]<ID_TEXTURE>
[..Color]<ID_COLOR>
[..Mono]<ID_MONO>
[..Reverse]<ID_REVERSE>
; -----------------------------------------
<Windows>
The Windows Dialog Box
This dialog box lists all the open windows.
Select one and choose OK to make that window
the active one.
; -----------------------------------------
<Log>
The Log Message Dialog Box
======== Text needed =========
; -----------------------------------------
;
; Following are keyword reference definition windows
;
; -----------------------------------------
<inactive>
An inactive menu command is one that is, for
the moment, not available. The command becomes
active at another time when conditions within
the program require or permit its use.
; -----------------------------------------
<shortcut>
Function keys are key combinations that
you can press to execute a menu command
without selecting the pull-down menu
itself. Not all menu commands have
function keys. The most frequently used
operations do.
; -----------------------------------------
<logging>
The message log is a debug tool. You should
delete it from the system by turning off the
INCLUDE_LOGGING global definition in dflat.h.
You should then eliminate references to it in
the MEMOPAD.TXT help database.
; -----------------------------------------
<MoreWins>
A menu can have only so many selections.
The length of the screen is the limiting
factor. The CUA standard defines nine
windows as the maximum number of windows
that the Window menu can display. The
Windows menu has the More Windows command
to provide a way for you to choose from
the rest of the document windows.
; -----------------------------------------
<API>
Applications Program Interface (API):
The functions, messages, macros, and
data structures that a programmer
uses to interface with the processes
of a function library.
; -----------------------------------------
<Block>
Marking Text Blocks
Marked text blocks affect the operation of these
commands:
[..Cut]<ID_CUT>
[..Copy]<ID_COPY>
[..Paste]<ID_PASTE>
[..Clear]<ID_CLEAR>
[..Delete]<ID_DELETETEXT>
[..Paragraph]<ID_PARAGRAPH>
Mark a text block by using one of these operations:
Keyboard:
---------
Hold the Shift key down and move the
keyboard cursor. The block will be marked in
reverse video.
To clear the marked block, release the Shift
key and press any text entry or cursor movement
key.
Mouse:
------
Click on the first or last character of the
block. Hold the mouse button down and move
the mouse cursor around. The marked block
will follow the mouse cursor.
To clear the marked block, release the mouse
cursor and click anywhere.
; -----------------------------------------
<Clipboard>
The Clipboard
The Clipboard is a scratchpad where you can save
text that can be pasted into a different location
in the same or another document. You save text with
the [..Copy]<ID_COPY> and [..Cut]<ID_CUT> commands, and you paste text into
from the Clipboard into a document with the [..Paste]<ID_PASTE>
command.
; -----------------------------------------
<toggle>
A toggle command is one that is
either on or off. When it is on,
its command on the menu is preceded
by a check mark (√).
<ID_CALENDAR>
Calendar
This command displays a calendar to demonstrate
the use of the PICTUREBOX class to draw line
vectors.
<ID_BARCHART>
Bar Chart
This command displays a bar chart to demonstrate
the use of the PICTUREBOX class to draw bars.
<Calendar>
Calendar
This calendar is an example of a picture box
with line vectors. The PgUp and PgDn keys
will page through the months. You can close
the window from the [..System Menu]<sysmenu>.
<BarChart>
Bar Chart
This window is an example of a bar chart. You
can close the window from the [..System Menu]<sysmenu>.
<end>